home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / gfx / board / ShowJPEG16.lha / ShowJPEG.doc < prev    next >
Text File  |  1995-04-26  |  10KB  |  345 lines
  1.  
  2.  
  3.             =========================
  4.  
  5.                  ShowJPEG V1.6
  6.  
  7.             =========================
  8.  
  9.  
  10.                   26. April, 1995
  11.  
  12.  
  13.           Copyright (c) 1994/95 by Roman Hiestand
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Copyright notice
  20. ----------------
  21.  
  22. The program ShowJPEG and its documentation are written and copyrighted by
  23. Roman Hiestand. They may be distributed freely providing the following
  24. restrictions are satisfied:
  25.  
  26. - Distributors may not charge more than the cost of a diskette used in
  27.   the distribution of this program.
  28.  
  29. - Distributors may only distribute the unmodified copy of the original
  30.   program, along with it's documentation, and copyright notices intact.
  31.  
  32. - Commercial  distribution  is  only  possible with written permission
  33.   from the author.
  34.  
  35.  
  36. Disclaimer
  37. ----------
  38.  
  39. This program and its documentation is provided "as is". No warranties are made
  40. with respect to the accuracy, reliability, performance or operation of this
  41. software and information. You are using this program at your own risk. The
  42. author is not liable for any damages that may have been caused by using this
  43. software.
  44.  
  45.  
  46.  
  47. Introduction
  48. ------------
  49.  
  50. It is done ! After hours and hours of hacking, debugging and #@©°!*-ing,
  51. this peace of software is ready to distribute:
  52.  
  53.                 ShowJPEG
  54.  
  55. the successor to the world-famous (:-) ShowGIF.
  56. I always wanted to replace the ViewJPEG delivered with the picasso-board,
  57. because it is buggy, incomplete and slow. But, you can believe me, jpeg
  58. is a tough and complicated topic. So I decided not to rewrite the whole
  59. thing but simply use the jpeg link-library from the independent JPEG
  60. software group. It is fairly quick and customizable, but it's big...
  61. That's why the program is quite large.
  62.  
  63.  
  64. Features
  65. --------
  66.  
  67.  - As compatible to the jpeg-standard as software can be
  68.  - Supports greyscaled pictures
  69.  - Various speed/quality tradeoff settings
  70.  - Fast
  71.  - CLI or WB start
  72.  - Can be aborted anytime (with Ctrl-C or Escape)
  73.  - Filerequester (since V1.2)
  74.  - Pattern matching (since V1.3)
  75.  - Nocrop option (since V1.4)
  76.  - Doesn't switches back to screen behind (since V1.6)
  77.  
  78. Usage
  79. -----
  80.  
  81. From CLI: ShowJPEG File [...]
  82. From WB : via default tool or extended selection
  83.  
  84. Template:
  85. FILE/M,Q=QUALITY/K,SC=SCALE/N,DELAY/N,GRAY=GREY/S,VERBOSE/S,
  86.   8BIT/S,16BIT/S,24BIT/S,NOCENTER/S,ALL/S,NC=NOCROP/S
  87.  
  88. The options are accessible from CLI or Workbench.
  89.  
  90.  FILES/M    One or more filenames
  91.         Example: ShowJPEG DF0:Pictures/Tron.JPEG
  92.  
  93.  Q=QUALITY/K    The quality, one of BEST, NORMAL [default] or FAST.
  94.         BEST is always the best it can do, NORMAL is what I
  95.         considered as good enough but not too slow, and FAST
  96.         is always the fastest.
  97.         For more information see below.
  98.         Examples: ShowJPEG Tron.JPEG Q=BEST
  99.               ShowJPEG Tron.JPEG QUALITY BEST
  100.               ShowJPEG Tron.JPEG Q FAST
  101.         Default: NORMAL
  102.  
  103.  SC=SCALE/N    The scale factor, one of 1, 2, 4 or 8 (-> 1/1, 1/2..).
  104.         If you want to see a very large picture in whole or
  105.         you want to have just a quick preview, use scale.
  106.         Example: ShowJPEG BigPicture.jpg SCALE 2
  107.              ShowJPEG VeryBigPicture.jpg SC=8
  108.         Default: 1
  109.  
  110.  DELAY/N    Waits n seconds after displaying the picture.
  111.         Example: ShowJPEG Slideshow/*.jpg DELAY=5
  112.         Default: off
  113.  
  114.  GRAY=GREY/S    Displays the picture in grayscale. Use this if you
  115.         want to have a quick preview.
  116.         Example: ShowJPEG SlowPicture.jpg GREY
  117.         Default: off
  118.  
  119.  VERBOSE/S    Prints out information about the picture:
  120.         Width x Height x Depth of the picture ->
  121.         Width x Height x Depth of the screen
  122.         Example: ShowJPEG VERBOSE Pic.jpg
  123.         Default: off
  124.  
  125.  8BIT/16BIT/24BIT
  126.         Use these options if you want the picture displayed
  127.         in a certain screen depth. If it doesn't fit the
  128.         screen it's being cropped.
  129.         Example: ShowJPEG 24BIT LargePicture.jpeg
  130.         Default: off, this means the screen is chosen such
  131.         that the whole image fits the screen. If the image
  132.         is larger than the largest 8-Bit-screen the image
  133.         is cropped.
  134.  
  135.  NOCENTER/S    Don't display the picture in the center of the
  136.         screen.
  137.         Default: off
  138.  
  139.  ALL/S        Searches all subdirectories for the supplied
  140.         pattern (see also: Pattern matching).
  141.         Default: off
  142.  
  143.  NC=NOCROP/S    Simply put: if you set NOCROP, your picture won't
  144.         be cropped. It will be scaled, if necessary. If you
  145.         supply also the display depth, this one will be used.
  146.         If you didn't supply a depth, then after each scale-
  147.         step the depth will be reconsidered, meaning: it 
  148.         choses the highest possible depth for the scaled
  149.         picture (If this explanation confused you, try
  150.         it out with VERBOSE set).
  151.         Example: ShowJPEG 24BIT LargePicture.jpeg
  152.         This LargePicture will be scaled until it fits a
  153.         24 bit resolution.
  154.         Default: off
  155.  
  156. Remark: the BEHIND-option has been dropped. There exists now a new
  157. feature:
  158. If you display more than one picture, the new screen is opened in
  159. front of the old one. This means no more switching back to WB
  160. resolution. This is similar to what ViewGIF does.
  161.  
  162.  
  163. Every combination of options is possible:
  164.  
  165.  ShowJPEG QUALITY BEST DF0:Pictures/Tron.jpeg
  166.  ShowJPEG Q=FAST DH0:Art/MonaLisa.jpg
  167.  ShowJPEG DF0:Pictures/Tron.jpg 24BIT
  168.  ShowJPEG 8BIT DH0:Art/WindyDay.jpg DELAY 10 GREY VERBOSE
  169.  
  170. From Workbench:
  171. ShowJPEG reads it's own tooltypes and takes them as its
  172. defaults. It reads the tooltypes of every picture and uses
  173. these options, but they are switched back for the next
  174. picture.
  175.  
  176. Ctrl-C is now handled more correctly. You can break the whole
  177. program by typing Ctrl-C into the picture while it is being
  178. decoded. You can't break the program in the CLI !
  179. Since V1.5 you can now use Escape, too.
  180.  
  181.  
  182. The Quality setting
  183. -------------------
  184.  
  185. For those of you who know the jpeg-software:
  186.     - BEST means: Fancy upsampling
  187.       if quantizing: two pass quantize, Floyd-Steinberg dithering
  188.     - NORMAL means: normal upsampling
  189.       one pass quantize, ordered dithering
  190.     - FAST means: normal upsampling
  191.       one pass quantize, no dithering
  192.  
  193. In true/high color mode, the quality setting won't affect too much.
  194. But if the software has to reduce to 8 bits, the quality gain is very
  195. big: FAST is just a quick preview, NORMAL is not much slower but a quite
  196. good picture and BEST is what you could expect from any graphics
  197. software but is slow. (Anyway, BEST is ~3 times faster than ImageFX and
  198. gives similar results !)
  199. In BEST mode it (normally) uses a temporary file in T:, so don't set this
  200. to RAM: unless you have >2 Megs of free RAM.
  201.  
  202.  
  203. Pattern Matching
  204. ----------------
  205. (Note: * only works if you use WildStar or a similar program. Use #?
  206. instead)
  207.  
  208. Since V1.3 pattern matching is implemented. As this is a complex matter
  209. and it's not really the same in every program, I describe it in this
  210. chapter.
  211. ShowJPEG splits your supplied pattern into two parts:
  212.  
  213.     ShowJPEG    DF0:Pictures/*.jpg
  214.             | Path      || pattern \
  215.  
  216.  - The easy case: the path is not a pattern
  217.    ShowJPEG just searches the pattern in the supplied path and displays
  218.    every picture found.
  219.    Example: ShowJPEG DF0:Pictures/*.jpg
  220.     displays every picture in DF0:Pictures with .jpg at the end.
  221.         ShowJPEG DF0:Pictures/A*
  222.     displays every picture in DF0:Pictures starting with A or a.
  223.  
  224.    If you add 'ALL', the supplied path is taken as a starting point.
  225.    Every subdirectory is now searched for the pattern.
  226.    Example: ShowJPEG DF0:*.jpg ALL
  227.     displays every picture in DF0: and its subdirectories with
  228.     .jpg at the end.
  229.  
  230.  - The complex case: the path is a pattern
  231.    ShowJPEG searches now every path that matches the path pattern for
  232.    the file pattern.
  233.    The same with 'ALL', but now every subdirectory is searched too.
  234.    Example: ShowJPEG DH0:G*/A*.jpg
  235.     displays every picture in DH0:Graphics, DH0:Games ...
  236.     that matches A*.jpg (A at the beginning and .jpg at the end)
  237.         ShowJPEG DH0:G*/A*.jpg
  238.     displays every picture in all subdirectories of DH0:Graphics,
  239.     DH0:Games ... that matches A*.jpg
  240.         ShowJPEG DH0:G*/*.jpg
  241.     displays every .jpg picture in every subdirectory of
  242.     every directory starting with DH0:G (this can be a lot !)
  243.  
  244.  
  245. Of course, every standard pattern matching characters can be used:
  246.   ?  Matches any single character
  247.   #  Matches zero or more of the following character
  248.   |  Separates OR clauses
  249.   *  Matches any number of arbitrary characters (only with WildStar)
  250.  
  251. Examples:
  252.  - *.jpg matches Tron.jpg, Picture.jpg
  253.  - #a.jpg matches .jpg, a.jpg, aa.jpg, aaa.jpg ...
  254.  - A* matches Ape.jpg, a.jpg, Amiga.jpg (but also: Amiga.jpg.info !)
  255.  - a(b|c).jpg matches ab.jpg and ac.jpg
  256.  
  257. Pattern matching is NOT case sensitive.
  258.  
  259.  
  260. Requirements
  261. ------------
  262.  
  263. Kick 2.0 and vilintuisup.library version > 2.0.
  264.  
  265.  
  266. Bugs
  267. ----
  268.  
  269.  - Some people reported to me that they couldn't load pictures from
  270.    CD-ROM. I have no idea why this happens. Any suggestions ?
  271.  
  272. I tested the program with various JPEG-pictures and with Enforcer on my 
  273. A3000. No misbehaviour could be found. But on different computer-systems
  274. with different environments, nobodoy knows what's gonna happen...
  275. If you find a bug, please report it to me together with as much information
  276. as possible that could help me to fix it: your computer, configuration, kick
  277. version and so on.
  278.  
  279.  
  280. Thanks
  281. ------
  282.  
  283. My thanks go to:
  284.  
  285.  - VillageTronic for their wonderful card
  286.  - the developers of the GNU-C-compiler and libnix
  287.  - the Independent JPEG Group for their software
  288.  
  289.  
  290. Future plans
  291. ------------
  292.  
  293.  - ??
  294.  
  295. Tell me if you want to have more options !
  296.  
  297.  
  298. Revisions
  299. ---------
  300.  
  301.     1.0    -    first public release
  302.  
  303.     1.1    -    Added NOCENTER
  304.             Remark: different default behaviour, it displays
  305.             now a picture in the center of the screen
  306.             (requested by Stefan Hülswitt)
  307.  
  308.     1.2    -    Added Filerequester
  309.             When no picture could be loaded, a file requester
  310.             pops up
  311.  
  312.     1.3    -    Added Pattern matching
  313.             Handles Ctrl-C better
  314.  
  315.     1.4    -    Added NOCROP option, rewrote OpenScreen code
  316.             (requested by Stefan Huelswitt and Antti Miettinen)
  317.             Corrected small bug (grey picture handling)
  318.             Compiled with gcc 2.6.3
  319.             Linked with jpeg library 5a and libnix 0.7
  320.  
  321.     1.5    -    Escape behaves now like Ctrl-C
  322.             Added BEHIND option (requested by Henning Sauer)
  323.  
  324.     1.6    -    WB message window now waits for close button
  325.             Removed BEHIND option in favor of a new
  326.             screen handling
  327.             New OpenScreen code
  328.             Linked with jpeg library 5b and libnix 0.8
  329.  
  330.  
  331.  
  332. Address
  333. -------
  334.  
  335. I can be reached at
  336.  
  337. Roman Hiestand
  338. Luziaweg 15
  339. CH-8807 Freienbach
  340. Switzerland
  341.  
  342. Fax: CH-055/48 26 37
  343.  
  344. email: rhiestan@iiic.ethz.ch
  345.